home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / term-2.3.5 / README.porting < prev    next >
Encoding:
Text File  |  1995-07-14  |  2.4 KB  |  81 lines
  1. WHAT IS THIS?
  2. ~~~~~~~~~~~~~
  3. I've added in the following routines to make porting easier:
  4.    term_gethostbyname()
  5.    term_connect()
  6.    term_rcmd()
  7.    term_bind()
  8.    term_getsockname()
  9.    term_listen()
  10.    term_accept()
  11.    term_shutdown()
  12.    term_close()
  13.    .
  14.    .
  15.    .
  16.  
  17. At the end if this file I've included instructions for using these new routines
  18. I've tried to make it so "term" binaries will be usable for users of other
  19. networking software as well.  Sometime in the future, users might be able to
  20. modified their shared libraries instead of recompiling everything.  For now
  21. this is still sometime off in the distant future.
  22.  
  23. For programs that were ported back in the days of client.a, you can still
  24. recompile them for use with newer versions of term simply by changing the
  25. client.a reference to libtermnet.a
  26.  
  27. PORTING OF SOFTWARE:
  28. ~~~~~~~~~~~~~~~~~~~~
  29. Here is the new simplified porting procedure.
  30.  
  31. If installed in /usr/local by root:
  32.  
  33.   1. Add to the compile flags "-include /usr/local/include/termnet.h"
  34.   2. Add to the library list "-ltermnet"
  35.  
  36. If installed in your home directory:
  37.  
  38.   1. Add to the compile flags "-include ~/term/termnet.h"
  39.   2. Add to the library list "-L ~/term -ltermnet"
  40.  
  41. That should do it!!!  If you are using term in "shared" mode, you'll need:
  42.  
  43. As root:
  44.  
  45.   chgrp term <filenames>
  46.   chmod g+s <filenames>
  47.  
  48. As an ordinary user:
  49.  
  50.   chmod u+s <filenames>
  51.  
  52. Some commands like "rlogin" will be privileged.  i.e. Only the person who
  53. started "term" and "root" may use privileged commands.
  54.  
  55.  
  56. Some term commands will be "term" transparent and only use term when there
  57. is not another option.  Some common examples are:
  58.     telnet, ftp, ...
  59.  
  60. Others require an external flag to tell them it is all right to use term.  These
  61. programs include:
  62.     xarchie, fsp, ytalk, ...
  63.  
  64. You can either flag these programs to use term by setting the environmental
  65. variable TERMMODE as specified in README.security, or running "make installnet".
  66. Eventually the "termnet" file created will contain special networking
  67. instructions, but for now only its existence is checked.
  68.  
  69. If you add an ethernet connection, you can then simply remove the "termnet"
  70. file and continue to use the same binaries!
  71.  
  72.  
  73. PORTING CAVEAT:
  74. ~~~~~~~~~~~~~~~~
  75.  
  76. The termnet functions don't always act exactly like real networking code.
  77. Still needed:
  78.  - To deal with duplicated socket descriptors.
  79.  - To gracefully deal with binds to privileged ports and other misc. problems.
  80.  
  81.